Lines Matching full:markdown
1 <h1>Markdown: Syntax</h1>
4 <li><a href="/projects/markdown/" title="Markdown Project Page">Main</a></li>
5 <li><a href="/projects/markdown/basics" title="Markdown Basics">Basics</a></li>
6 <li><a class="selected" title="Markdown Syntax Documentation">Syntax</a></li>
7 <li><a href="/projects/markdown/license" title="Pricing and License Information">License</a></li>
8 <li><a href="/projects/markdown/dingus" title="Online Markdown Web Form">Dingus</a></li>
41 <p><strong>Note:</strong> This document is itself written using Markdown; you
42 can <a href="/projects/markdown/syntax.text">see the source for it by adding '.text' to the URL</a>.</p>
50 <p>Markdown is intended to be as easy-to-read and easy-to-write as is feasible.</p>
52 <p>Readability, however, is emphasized above all else. A Markdown-formatted
55 Markdown's syntax has been influenced by several existing text-to-HTML
58 inspiration for Markdown's syntax is the format of plain text email.</p>
60 <p>To this end, Markdown's syntax is comprised entirely of punctuation
63 look like *emphasis*. Markdown lists look like, well, lists. Even
69 <p>Markdown's syntax is intended for one purpose: to be used as a
72 <p>Markdown is not a replacement for HTML, or even close to it. Its
76 insert. The idea for Markdown is to make it easy to read, write, and
77 edit prose. HTML is a <em>publishing</em> format; Markdown is a <em>writing</em>
78 format. Thus, Markdown's formatting syntax only addresses issues that
81 <p>For any markup that is not covered by Markdown's syntax, you simply
83 indicate that you're switching from Markdown to HTML; you just use
89 not be indented with tabs or spaces. Markdown is smart enough not
92 <p>For example, to add an HTML table to a Markdown article:</p>
105 <p>Note that Markdown formatting syntax is not processed within block-level
106 HTML tags. E.g., you can't use Markdown-style <code>*emphasis*</code> inside an
110 used anywhere in a Markdown paragraph, list item, or header. If you
111 want, you can even use HTML tags instead of Markdown formatting; e.g. if
112 you'd prefer to use HTML <code><a></code> or <code><img></code> tags instead of Markdown's
115 <p>Unlike block-level HTML tags, Markdown syntax <em>is</em> processed within
142 <p>Markdown allows you to use these characters naturally, taking care of
152 <p>and Markdown will leave it alone. But if you write:</p>
157 <p>Markdown will translate it to:</p>
162 <p>Similarly, because Markdown supports <a href="#html">inline HTML</a>, if you use
163 angle brackets as delimiters for HTML tags, Markdown will treat them as
169 <p>Markdown will translate it to:</p>
174 <p>However, inside Markdown code spans and blocks, angle brackets and
176 Markdown to write about HTML code. (As opposed to raw HTML, which is a
192 that Markdown supports "hard-wrapped" text paragraphs. This differs
197 <p>When you <em>do</em> want to insert a <code><br /></code> break tag using Markdown, you
201 "every line break is a <code><br /></code>" rule wouldn't work for Markdown.
202 Markdown's email-style <a href="#blockquote">blockquoting</a> and multi-paragraph <a href="#list">list items</a>
207 <p>Markdown supports two styles of headers, <a href="http://docutils.sourceforge.net/mirror/setext.html">Setext</a> and <a href="http://www.aaronsw.com/2002/atx/">atx</a>.</p>
246 <p>Markdown uses email-style <code>></code> characters for blockquoting. If you're
248 know how to create a blockquote in Markdown. It looks best if you hard
259 <p>Markdown allows you to be lazy and only put the <code>></code> before the first
280 <p>Blockquotes can contain other Markdown elements, including headers, lists,
299 <p>Markdown supports ordered (numbered) and unordered (bulleted) lists.</p>
331 list have no effect on the HTML output Markdown produces. The HTML
332 Markdown produces from the above list is:</p>
341 <p>If you instead wrote the list in Markdown like this:</p>
356 you can use ordinal numbers in your ordered Markdown lists, so that
361 list with the number 1. At some point in the future, Markdown may support
386 <p>If list items are separated by blank lines, Markdown will wrap the
432 paragraphs, but here again, Markdown will allow you to be
477 of a code block are interpreted literally. Markdown wraps a code block
480 <p>To produce a code block in Markdown, simply indent every line of the
488 <p>Markdown will generate:</p>
521 easy to include example HTML source code using Markdown -- just paste
522 it and indent it, and Markdown will handle the hassle of encoding the
538 <p>Regular Markdown syntax is not processed within code blocks. E.g.,
540 it's also easy to use Markdown to write about Markdown's own syntax.</p>
568 <p>Markdown supports two style of links: <em>inline</em> and <em>reference</em>.</p>
638 <p>Link definitions are only used for creating links during Markdown
673 <p>Link definitions can be placed anywhere in your Markdown document. I
707 Markdown's inline link style:</p>
722 <p>With Markdown's reference-style links, a source document much more
730 <p>Markdown treats asterisks (<code>*</code>) and underscores (<code>_</code>) as indicators of
816 tags. Markdown will turn this:</p>
842 <p>Markdown uses an image syntax that is intended to resemble the syntax
874 <p>As of this writing, Markdown has no syntax for specifying the
884 <p>Markdown supports a shortcut style for creating "automatic" links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this:</p>
889 <p>Markdown will turn this into:</p>
895 Markdown will also perform a bit of randomized decimal and hex
897 spambots. For example, Markdown will turn this:</p>
919 <p>Markdown allows you to use backslash escapes to generate literal
920 characters which would otherwise have special meaning in Markdown's
928 <p>Markdown provides backslash escapes for the following characters:</p>
